Home Assistant Anleitung fuer die Dual PID Custom Integration

1. Dateien kopieren

Kopiere den Ordner
custom_components\dual_pid

nach Home Assistant in:
/config/custom_components/dual_pid

Am Ende sollte es dort z.B. so aussehen:
- /config/custom_components/dual_pid/manifest.json
- /config/custom_components/dual_pid/__init__.py
- /config/custom_components/dual_pid/config_flow.py


2. Home Assistant neu starten

Danach Home Assistant komplett neu starten.
Ein reines "Automationen neu laden" reicht nicht, weil custom_components nur beim Start geladen werden.


3. Integration hinzufuegen

Dann in Home Assistant:
1. Einstellungen
2. Geraete & Dienste
3. Integration hinzufuegen
4. nach "Dual PID Espresso" suchen

Falls die Integration dort nicht auftaucht:
- pruefen, ob der Ordnername exakt dual_pid heisst
- pruefen, ob wirklich unter /config/custom_components/dual_pid kopiert wurde
- Home Assistant Protokoll oeffnen und nach dual_pid suchen


4. Konfiguration in der UI

Im Dialog eintragen:
- Name: frei waehlbar, z.B. "Espressomaschine"
- Host / IP-Adresse: z.B. 192.168.178.50
- Port: normalerweise 80
- Aktualisierungsintervall: z.B. 10 Sekunden

Wichtig:
Die Maschine muss im Netzwerk erreichbar sein und bereits die neue Firmware mit der API haben, also mindestens:
- GET /api/status
- POST /api/start
- POST /api/standby/on
- POST /api/standby/off


5. Nach erfolgreicher Einrichtung

Dann sollte in Home Assistant ein neues Geraet erscheinen mit Entitaeten wie:
- Standby
- Jetzt aufheizen
- Status
- Wasser Temperatur
- Wasser Sollwert
- Dampf Temperatur
- Dampf Sollwert
- diverse Binaersensoren wie Eco aktiv, Dampfverzoegerung aktiv, Zeit synchronisiert


6. Ins Dashboard aufnehmen

Am einfachsten:
1. Geraet oeffnen
2. "Zum Dashboard hinzufuegen"
3. gewuenschte Entitaeten auswaehlen

Oder manuell in einer Entities-Karte.


7. Wenn etwas nicht funktioniert

Zuerst diese Punkte pruefen:
- Browser-Test: http://DEINE-IP/api/status
- Es muss JSON zurueckkommen
- Wenn dort nichts kommt, liegt es an der Maschine/API, nicht an Home Assistant

Zusaetzlich in Home Assistant:
- Einstellungen > System > Protokolle
- nach dual_pid suchen


8. Typische Fehlerursachen

- falscher Zielpfad beim Kopieren
- falscher Ordnername
- Home Assistant nicht neu gestartet
- Maschine noch mit aelterer Firmware
- IP-Adresse geaendert
- Firewall oder Netzwerk blockiert den Zugriff
